﻿using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using UtilZ.Dotnet.Ex.Attributes;
using UtilZ.Dotnet.Ex.ValueDescription;

namespace UtilZ.Dotnet.Ex.Communication.Net.Web
{
    /// <summary>
    /// HTTP状态码
    /// </summary>
    public class HttpStatusCodes
    {
        private readonly static ValueDescriptionGroup<int> _group = null;
        static HttpStatusCodes()
        {
            _group = new ValueDescriptionGroup<int>(typeof(HttpStatusCodes), "HTTP状态码");
        }
        

        /// <summary>
        /// 获取http状态码名称
        /// </summary>
        /// <param name="statusCode">http状态码</param>
        /// <returns>http状态码名称</returns>
        public static string GetStatusCodeName(int statusCode)
        {
            string name;
            if (_group.TryGetNameByValue(statusCode, out name))
            {
                return name;
            }
            else
            {
                return $"未知的http状态码\"{statusCode}\"";
            }
        }

        /// <summary>
        /// 获取http状态码描述
        /// </summary>
        /// <param name="statusCode">http状态码</param>
        /// <returns>http状态码描述</returns>
        public static string GetStatusCodeDes(int statusCode)
        {
            string des;
            if (_group.TryGetDescriptionByValue(statusCode, out des))
            {
                return des;
            }
            else
            {
                return $"未知的http状态码\"{statusCode}\"";
            }
        }







        /********************************************************************************
         * HTTP 状态码分类
         * HTTP 状态码由三个十进制数字组成，第一个十进制数字定义了状态码的类型。
         * 响应分为五类：
         * 信息响应(100–199)，
         * 成功响应(200–299)，
         * 重定向(300–399)，
         * 客户端错误(400–499)，
         * 服务器错误(500–599)：
         * 
         * 分类 分类描述
         * 1** 	信息，服务器收到请求，需要请求者继续执行操作
         * 2** 	成功，操作被成功接收并处理
         * 3** 	重定向，需要进一步的操作以完成请求
         * 4** 	客户端错误，请求包含语法错误或无法完成请求
         * 5** 	服务器错误，服务器在处理请求的过程中发生了错误
         ********************************************************************************/










        /// <summary>
        /// 继续。客户端应继续其请求
        /// </summary>
        [DisplayNameEx("Continue"), Description("客户端应继续其请求")]
        public const int Continue = 100;

        /// <summary>
        /// 切换协议。服务器根据客户端的请求切换协议。只能切换到更高级的协议，例如，切换到HTTP的新版本协议
        /// </summary>
        [DisplayNameEx("SwitchingProtocols"), Description("服务器根据客户端的请求切换协议。只能切换到更高级的协议，例如，切换到HTTP的新版本协议")]
        public const int SwitchingProtocols = 101;









        /// <summary>
        /// 请求成功。一般用于GET与POST请求
        /// </summary>
        [DisplayNameEx("OK"), Description("一般用于GET与POST请求")]
        public const int OK = 200;

        /// <summary>
        /// 已创建。成功请求并创建了新的资源
        /// </summary>
        [DisplayNameEx("Created"), Description("成功请求并创建了新的资源")]
        public const int Created = 201;

        /// <summary>
        ///  已接受。已经接受请求，但未处理完成
        /// </summary>
        [DisplayNameEx("Accepted"), Description("已经接受请求，但未处理完成")]
        public const int Accepted = 202;

        /// <summary>
        /// 非授权信息。请求成功。但返回的meta信息不在原始的服务器，而是一个副本
        /// </summary>
        [DisplayNameEx("NonAuthoritativeInformation"), Description("请求成功。但返回的meta信息不在原始的服务器，而是一个副本")]
        public const int Non_Authoritative_Information = 203;

        /// <summary>
        /// 无内容。服务器成功处理，但未返回内容。在未更新网页的情况下，可确保浏览器继续显示当前文档
        /// </summary>
        [DisplayNameEx("NoContent"), Description("服务器成功处理，但未返回内容。在未更新网页的情况下，可确保浏览器继续显示当前文档")]
        public const int NoContent = 204;

        /// <summary>
        /// 重置内容。服务器处理成功，用户终端（例如：浏览器）应重置文档视图。可通过此返回码清除浏览器的表单域
        /// </summary>
        [DisplayNameEx("ResetContent"), Description("服务器处理成功，用户终端（例如：浏览器）应重置文档视图。可通过此返回码清除浏览器的表单域")]
        public const int ResetContent = 205;

        /// <summary>
        ///  部分内容。服务器成功处理了部分GET请求
        /// </summary>
        [DisplayNameEx("PartialContent"), Description("服务器成功处理了部分GET请求")]
        public const int PartialContent = 206;













        /// <summary>
        /// 多种选择。请求的资源可包括多个位置，相应可返回一个资源特征与地址的列表用于用户终端（例如：浏览器）选择
        /// </summary>
        [DisplayNameEx("MultipleChoices"), Description("请求的资源可包括多个位置，相应可返回一个资源特征与地址的列表用于用户终端（例如：浏览器）选择")]
        public const int MultipleChoices = 300;

        /// <summary>
        ///  永久移动。请求的资源已被永久的移动到新URI，返回信息会包括新的URI，浏览器会自动定向到新URI。今后任何新的请求都应使用新的URI代替
        /// </summary>
        [DisplayNameEx("MovedPermanently"), Description("请求的资源已被永久的移动到新URI，返回信息会包括新的URI，浏览器会自动定向到新URI。今后任何新的请求都应使用新的URI代替")]
        public const int MovedPermanently = 301;

        /// <summary>
        /// 临时移动。与301类似。但资源只是临时被移动。客户端应继续使用原有URI
        /// </summary>
        [DisplayNameEx("Found"), Description("与301类似。但资源只是临时被移动。客户端应继续使用原有URI")]
        public const int Found = 302;

        /// <summary>
        ///  查看其它地址。与301类似。使用GET和POST请求查看
        /// </summary>
        [DisplayNameEx("SeeOther"), Description("与301类似。使用GET和POST请求查看")]
        public const int SeeOther = 303;

        /// <summary>
        ///  未修改。所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。客户端通常会缓存访问过的资源，通过提供一个头信息指出客户端希望只返回在指定日期之后修改的资源
        /// </summary>
        [DisplayNameEx("NotModified"), Description("所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。客户端通常会缓存访问过的资源，通过提供一个头信息指出客户端希望只返回在指定日期之后修改的资源")]
        public const int NotModified = 304;

        /// <summary>
        /// 使用代理。所请求的资源必须通过代理访问
        /// </summary>
        [DisplayNameEx("UseProxy"), Description("所请求的资源必须通过代理访问")]
        public const int UseProxy = 305;

        /// <summary>
        /// 已经被废弃的HTTP状态码
        /// </summary>
        [DisplayNameEx("Unused"), Description("已经被废弃的HTTP状态码")]
        public const int Unused = 306;

        /// <summary>
        /// 临时重定向。与302类似。使用GET请求重定向
        /// </summary>
        [DisplayNameEx("TemporaryRedirect"), Description("临时重定向,与302类似。使用GET请求重定向")]
        public const int TemporaryRedirect = 307;











        /// <summary>
        /// 客户端请求的语法错误，服务器无法理解
        /// </summary>
        [DisplayNameEx("BadRequest"), Description("客户端请求的语法错误，服务器无法理解")]
        public const int BadRequest = 400;

        /// <summary>
        /// 请求要求用户的身份认证
        /// </summary>
        [DisplayNameEx("Unauthorized"), Description("未认证,请求要求用户的身份认证")]
        public const int Unauthorized = 401;

        /// <summary>
        /// 保留，将来使用
        /// </summary>
        [DisplayNameEx("PaymentRequired"), Description("保留将来使用")]
        public const int PaymentRequired = 402;

        /// <summary>
        ///  服务器理解请求客户端的请求，但是拒绝执行此请求
        /// </summary>
        [DisplayNameEx("Forbidden"), Description("拒绝请求,服务器理解请求客户端的请求，但是拒绝执行此请求")]
        public const int Forbidden = 403;

        /// <summary>
        /// 服务器无法根据客户端的请求找到资源（网页）。通过此代码，网站设计人员可设置"您所请求的资源无法找到"的个性页面
        /// </summary>
        [DisplayNameEx("NotFound"), Description("请求的资源无法找到,服务器无法根据客户端的请求找到资源（网页）。通过此代码，网站设计人员可设置\"您所请求的资源无法找到\"的个性页面")]
        public const int NotFound = 404;

        /// <summary>
        /// 客户端请求中的方法被禁止
        /// </summary>
        [DisplayNameEx("MethodNotAllowed"), Description("客户端请求中的方法被禁止")]
        public const int MethodNotAllowed = 405;

        /// <summary>
        /// 服务器无法根据客户端请求的内容特性完成请求
        /// </summary>
        [DisplayNameEx("NotAcceptable"), Description("服务器无法根据客户端请求的内容特性完成请求")]
        public const int NotAcceptable = 406;

        /// <summary>
        /// 请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权
        /// </summary>
        [DisplayNameEx("ProxyAuthenticationRequired"), Description("请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权")]
        public const int ProxyAuthenticationRequired = 407;

        /// <summary>
        /// 服务器等待客户端发送的请求时间过长，超时
        /// </summary>
        [DisplayNameEx("RequestTimeout"), Description("服务器等待客户端发送的请求时间过长，超时")]
        public const int RequestTimeout = 408;

        /// <summary>
        /// 服务器完成客户端的PUT请求时可能返回此代码，服务器处理请求时发生了冲突
        /// </summary>
        [DisplayNameEx("Conflict"), Description("服务器完成客户端的PUT请求时可能返回此代码，服务器处理请求时发生了冲突")]
        public const int Conflict = 409;

        /// <summary>
        /// 客户端请求的资源已经不存在。410不同于404，如果资源以前有现在被永久删除了可使用410代码，网站设计人员可通过301代码指定资源的新位置
        /// </summary>
        [DisplayNameEx("Gone"), Description("客户端请求的资源已经不存在,410不同于404，如果资源以前有现在被永久删除了可使用410代码，网站设计人员可通过301代码指定资源的新位置")]
        public const int Gone = 410;

        /// <summary>
        /// 服务器无法处理客户端发送的不带Content-Length的请求信息
        /// </summary>
        [DisplayNameEx("请求需要Content-Length"), Description("服务器无法处理客户端发送的不带Content-Length的请求信息")]
        public const int LengthRequired = 411;

        /// <summary>
        /// 客户端请求信息的先决条件错误
        /// </summary>
        [DisplayNameEx("PreconditionFailed"), Description("客户端请求信息的先决条件错误")]
        public const int PreconditionFailed = 412;

        /// <summary>
        /// 由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息
        /// </summary>
        [DisplayNameEx("RequestEntityTooLarge"), Description("由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息")]
        public const int RequestEntityTooLarge = 413;

        /// <summary>
        ///  请求的URI过长（URI通常为网址），服务器无法处理
        /// </summary>
        [DisplayNameEx("RequestURITooLarge"), Description("请求的URI过长（URI通常为网址），服务器无法处理")]
        public const int RequestURITooLarge = 414;

        /// <summary>
        /// 服务器无法处理请求附带的媒体格式
        /// </summary>
        [DisplayNameEx("UnsupportedMediaType"), Description("服务器无法处理请求附带的媒体格式")]
        public const int UnsupportedMediaType = 415;

        /// <summary>
        /// 客户端请求的范围无效
        /// </summary>
        [DisplayNameEx("RequestedRangeNotSatisfiable"), Description("客户端请求的范围无效")]
        public const int RequestedRangeNotSatisfiable = 416;

        /// <summary>
        /// 服务器无法满足Expect的请求头信息
        /// </summary>
        [DisplayNameEx("ExpectationFailed"), Description("服务器无法满足Expect的请求头信息")]
        public const int ExpectationFailed = 417;











        /// <summary>
        /// 服务器内部错误，无法完成请求
        /// </summary>
        [DisplayNameEx("InternalServerError"), Description("服务器内部错误，无法完成请求")]
        public const int InternalServerError = 500;

        /// <summary>
        /// 服务器不支持请求的功能，无法完成请求
        /// </summary>
        [DisplayNameEx("NotImplemented"), Description("服务器不支持请求的功能，无法完成请求")]
        public const int NotImplemented = 501;

        /// <summary>
        /// 作为网关或者代理工作的服务器尝试执行请求时，从远程服务器接收到了一个无效的响应
        /// </summary>
        [DisplayNameEx("BadGateway"), Description("作为网关或者代理工作的服务器尝试执行请求时，从远程服务器接收到了一个无效的响应")]
        public const int BadGateway = 502;

        /// <summary>
        /// 由于超载或系统维护，服务器暂时的无法处理客户端的请求。延时的长度可包含在服务器的Retry-After头信息中
        /// </summary>
        [DisplayNameEx("ServiceUnavailable"), Description("由于超载或系统维护，服务器暂时的无法处理客户端的请求。延时的长度可包含在服务器的Retry-After头信息中")]
        public const int ServiceUnavailable = 503;

        /// <summary>
        /// 充当网关或代理的服务器，未及时从远端服务器获取请求
        /// </summary>
        [DisplayNameEx("GatewayTimeout"), Description("充当网关或代理的服务器，未及时从远端服务器获取请求")]
        public const int GatewayTimeout = 504;

        /// <summary>
        /// 服务器不支持请求的HTTP协议的版本，无法完成处理
        /// </summary>
        [DisplayNameEx("HTTPVersionNotSupported"), Description("服务器不支持请求的HTTP协议的版本，无法完成处理")]
        public const int HTTPVersionNotSupported = 505;
    }
}
